home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 5 / The 640 Meg Shareware Studio CD-ROM Volume V (Data Express)(1994).ISO / amiga / snapf20.lha / SnapFiles.doc next >
Text File  |  1994-06-06  |  8KB  |  222 lines
  1.  
  2.                      -* SnapFiles V2.0 By Glenn Wihlborg *-
  3.  
  4. Before I start to intruduce this program, I would like to thank Nico Franτois
  5. for writing SPOT.
  6.  
  7. So here's to you Nico, CHEERS! and keep up the good work.
  8.  
  9.  
  10. FEATURES
  11. »»»»»»»»
  12.  o Define your own extensions to search for.
  13.  o Three ways to save the #?.req file in. Use the announcers nodenumber,
  14.    announcers Boss's nodenumber or enter different nodnumber.
  15.  o Recognize characters between A-Z (both upper and lower case) and 0-9
  16.    as a filename.
  17.  o Finds filnames that are enclosed in non alphabetic chracters.
  18.  o Progressbar which indicates percentage of the message thats been scanned.
  19.  o Dupe check of found filenames.
  20.  o Total files found and dupe filnames are updated in the progressbar.
  21.  o Tag found filenames from a filelist.
  22.  o Multiple selection of filenames from a filelist - Require
  23.    rexxreqtools.library.
  24.  o Timer reporting elapsed time during scan in the progressbar.
  25.  o Total time report when the scan is over.
  26.  
  27. INTRODUCTION
  28. »»»»»»»»»»»»
  29. SnapFiles is offered to you under the concepts of 'NetmailWare'. That means,
  30. if you use it more than 30 days, I would like a netmail from you :):):):)
  31.  
  32. You are allowed to redistribute this package under the condition that the
  33. archive contains the following files:
  34.  
  35. Snapfiles.spot
  36. Snapfiles.doc
  37.  
  38. SnapFiles is a program to for Possible filenames in a message, with
  39. diffrent extensions. There are some predefined extensions but it's easy to
  40. add or remove them.
  41. I must remind you, this program search for "POSSIBLE" filenames.
  42.  
  43. So here it is, hope you enjoy it as much as I did writing it.
  44.  
  45. REQUIREMENTS
  46. »»»»»»»»»»»»
  47. Registered copy of Spot
  48. Arexx 
  49. rexxsupport.library (If you want multiple selection when taging files)
  50.  
  51. HOW TO USE
  52. »»»»»»»»»»
  53. You'll have to fix some minor details before it's up and runnig. You will
  54. find these variables among the first lines in the script.
  55.  
  56. 'PathName' path to your outbound dir, Must end with ':' or '/'.
  57.  
  58.  'TempDir' path to the tempfile.
  59.  
  60.  'RexxReq' if you have rexxreqtools.library installed, set this to 1
  61.            otherwise 0.
  62.  
  63. SnapFiles is only executeable in a message area. Run it and it will ask you
  64. in which nodenumber it should save the #?.req file. You will have the option
  65. to choose in three diffrent ways to save it.
  66.  
  67.  From: Snap the announcers nodenumber and save the #?.req file in that name.
  68.  
  69.  Boss: If the announcer is a point and he says that the file(s) can be found
  70.        in his boss's bbs. The program will replace his/her pointnumber with
  71.        a '0'.
  72.        e.g 2:200/600.39 -> 2.200.600.0
  73.  
  74. Other: Save the file in another nodenumber. Format of the string is either
  75.        Z:N/N.P or Z.N.N.P
  76.  
  77. When this is done it scans the message for the defined extensions. When
  78. it's finished there will pop up a requester saying how many files it could
  79. find or a requester telling you that it could not find any files.
  80.  
  81. The requester that tells you how many possible filenames it could find also
  82. have the option to 'TAG', 'ALL' and 'CANCEL'.
  83.  
  84.    Tag: Tag files from filelist. When you have selected the file(s) you
  85.         wanted, the filrequest window will show up. You can add and remove
  86.         files in this window to. But there is a few things to consider when
  87.         doing this.
  88.  
  89.         If rexxreqtools.library is installed you will have another
  90.         filerequester when taging files. You are then able to choose
  91.         all the files at the same time. Just hold down 'Shift' when
  92.         selecting files.
  93.  
  94.         If the person who announced the file(s) is a POINT you will have to
  95.         enter his point number in the 'node string requester'. The same
  96.         goes for if you are NOT using the nodenumber in the message header.
  97.         Otherwise you will not be able to edit the #?.req file, but if the
  98.         nodenumber is the one in the message header there should be no
  99.         problems.
  100.  
  101.    All: Include all the filenames it could find. To edit the file it's the
  102.         same procedure as in 'TAG' If the person who announced...so forth.
  103.  
  104. Cancel: Quit program.
  105.  
  106. HOW TO ADD AND REMOVE EXTENSIONS
  107. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  108. The varable NumExt must have the exact number of extensions you have
  109. defined.
  110.  
  111. E.g. If you have four extensions the NumExt should contain 4
  112.  
  113. NumExt = 4
  114.  
  115. Ext.1 = ".ZIP"
  116. Ext.2 = ".LHA"
  117. Ext.3 = ".LZH"
  118. Ext.4 = ".ARJ"
  119.  
  120. When you remove an extension you have to set the NumExt variable to the
  121. right value, otherwise it will not work propely. You can have as many
  122. defined extensions as you like (I think), have not tested with more than
  123. ten my self. But I don't see why there should be any limit to that.
  124.  
  125. The defined exetensions must be in order from one to what ever your last
  126. number will be.
  127.  
  128. NOTICE!!!
  129. »»»»»»»»»
  130. The routine to check if a word is a possible filename only recognize
  131. charcters between 0-9, A-Z (both upper and lower case).
  132.  
  133. E.g. '#?APF.Lha' Would be APF.Lha in the filelist.
  134.  
  135. DISCLAIMER
  136. »»»»»»»»»»
  137. I'm not responsible to any damage caused through the use or misuse
  138. of this product and so it must only be used at your own risk. All
  139. efforts have been made to ensure the stability of the program but
  140. this does not mean it is 100% safe. Please backup any important data
  141. that could be damaged through the use of this software until you are
  142. sure that it is stable.
  143.  
  144.  Any comments, bug reports or suggestions can be sent to:
  145.  
  146.  Glenn Wihlborg:
  147.  Fidonet 2:200/600.39
  148.  
  149. PROGRAMHISTORY
  150. »»»»»»»»»»»»»»
  151. Ver1.0   27-Dec-1993
  152. »»»»»»»»»»»»»»»»»»»»
  153.    First release :)
  154.  
  155. Ver1.1   3-Jan-1994
  156. »»»»»»»»»»»»»»»»»»»
  157.    A new search routine, it's allmost THREE times as fast as the one in
  158.    V1.0 and I think I dare to say it's 100 % safe. The routine in V1.0
  159.    checked EVERY word, very, very SLOW. This new routine ONLY check words
  160.    that contains a '.'
  161.  
  162.    Added progress requester when scanning for possible filenames. This
  163.    requester also allow you to abort the operation. Allso added a timer
  164.    so you can see how long time it took to search through the message,
  165.    it's not so usefull but...
  166.  
  167. Ver1.2   2-Feb-1994
  168. »»»»»»»»»»»»»»»»»»»
  169.    Added a requester where you can choose in which name you're gonna save
  170.    the #?.req file, the options are:
  171.        
  172.    From: Gets the announcers nodenumber and save the file in that name.
  173.  
  174.    Boss: If the announcer is a point and he says that the file(s) his
  175.          telling you about can be found in his boss's bbs, the program
  176.          will replace his pointnumber with a '0'.
  177.          E.g 2:200/600.39 -> 2.200.600.0.
  178.  
  179.    Other: Save the file in another nodenumber that you define your self,
  180.           but remeber the format of the name is Z.N.N.P
  181.  
  182. Ver1.3   27-Feb-1994
  183. »»»»»»»»»»»»»»»»»»»»
  184.    Bug fix in the 'Other' gadget. It didn't handle an empty string properly.
  185.  
  186. Ver2.0   27-May-1994
  187. »»»»»»»»»»»»»»»»»»»»
  188.    I think it's time for version 2.0 because many things has changed since
  189.    the last version.
  190.  
  191.    Removed the old way to edit the #?.req file. It was not so flexible lets
  192.    say that the message you scanned included 20 filenames. And you only
  193.    wanted to request three of them. Then you had to remove seventeen files
  194.    from the #?.req file, funny.....NOT. Now you are able to tag which file(s)
  195.    you want to request, from a filelist with the TAG gadget. Or use the ALL
  196.    gadget to tag all of them.
  197.          
  198.    Fixed the search routine, now it should recognize filenames that is
  199.    enclosed in certain characters like this:
  200.    'SNAPF20.LHA'
  201.    "SNAPF20.LHA"
  202.    'SNAPF20.LHA',
  203.    "SNAPF20.LHA".
  204.    SNAPF20.LHA.
  205.    SNAPF20.LHA,
  206.  
  207.    As you can see it also reqognize names that ends with a '.' or ','.
  208.    I did this because some people has the habbit to write the filenames in
  209.    that manner :) This new search routine may infect the speed a little.
  210.  
  211.    Included a dupe checking of the filenames, this will be shown' in the
  212.    proggress window. Together with total files found.
  213.  
  214.    Changed the string format of the 'Other' gadget. Now it can be either
  215.    Z.N/N.P or Z.N.N.P
  216.  
  217.    Now the timer is allso updated in the 'Progress bar'. I put it there
  218.    because sometimes it semes like the progressbar is standing still and the
  219.    program has stoped searching.
  220.  
  221.    Added multiple selection of files. But this require rexxreqtools.library.
  222.